.TH gmtime 3 "" "" ""
.SH SYNOPSIS
gmtime \- convert time to UTC traditional form
.SH ANSI_SYNOPSIS
#include <time.h>
.br
struct tm *gmtime(const time_t *
.IR clock );
.br
struct tm *gmtime_r(const time_t *
.IR clock ,
struct tm *
.IR res );
.br
.SH TRAD_SYNOPSIS
#include <time.h>
.br
struct tm *gmtime(
.IR clock )
.br
const time_t *
.IR clock ;
.br
struct tm *gmtime_r(
.IR clock ,
.IR res )
.br
const time_t *
.IR clock ;
.br
struct tm *
.IR res ;
.br
.SH DESCRIPTION
.BR gmtime 
assumes the time at 
.IR clock 
represents a local time.
.BR gmtime 
converts it to UTC (Universal Coordinated Time, also known in some
countries as GMT, Greenwich Mean time), then converts the
representation from the arithmetic representation to
the traditional representation defined by 
.BR struct tm .

.BR gmtime 
constructs the traditional time representation in static
storage; each call to 
.BR gmtime 
or 
.BR localtime 
will overwrite the
information generated by previous calls to either function.
.SH RETURNS
A pointer to the traditional time representation (
.BR struct tm ).
.SH PORTABILITY
ANSI C requires 
.BR gmtime .

.BR gmtime 
requires no supporting OS subroutines.
.SH SOURCE
src/newlib/libc/time/gmtime.c
